Welcome to Quarto

From course notes to journal articles to books

Mine Çetinkaya-Rundel

2023-08-06

What is Quarto?

Quarto …

• is a new, open-source, scientific, and technical publishing system
• aims to make the process of creating and collaborating dramatically better

Artwork from “Hello, Quarto” keynote by Julia Lowndes and Mine Çetinkaya-Rundel, presented at RStudio Conference 2022. Illustrated by Allison Horst.

A bit of magic

bit.ly/twq-welcome

Quarto …

unifies + extends the R Markdown ecosystem

Quarto …

unifies + extends the R Markdown ecosystem

unifies for people who love R Markdown

Quarto …

unifies + extends the R Markdown ecosystem

unifies for people who love R Markdown

extends for people who don’t know R Markdown

Quarto unifies + extends R Markdown

• Consistent implementation of attractive and handy features across outputs: tabsets, code-folding, syntax highlighting, etc.
• More accessible defaults as well as better support for accessibility
• Guardrails, particularly helpful for new learners: YAML completion, informative syntax errors, etc.
• Support for other languages like Python, Julia, Observable, and more via Jupyter engine for executable code chunks.

Quarto, in a nutshell

Anatomy of a Quarto document

YAML

Document metadata

title: "Hello, Penguins!"
format: html
editor: visual

title: "Hello, Penguins!"
author: Mine Çetinkaya-Rundel
institute: Duke University
date: now
...
format: html
editor: visual

Text

Markdown, that can be edited with any editor, including RStudio’s source or visual editors.

Code

R code chunks executed with knitr 31b8e172-b470-440e-83d8-e6b185028602:dAB5AHAAZQA6AE8AUQBCAGoAQQBHAEkAQQBOAHcAQQA1AEEARwBVAEEATgBnAEIAagBBAEMAMABBAE8AQQBBADQAQQBEAGcAQQBaAEEAQQB0AEEARABRAEEAWQBRAEEAdwBBAEcAVQBBAEwAUQBBADUAQQBHAE0AQQBPAFEAQgBpAEEAQwAwAEEAWgBnAEIAbQBBAEQAWQBBAE4AdwBCAGoAQQBHAFEAQQBOAEEAQQB3AEEARABRAEEAWgBRAEEAMgBBAEQAQQBBAAoAcABvAHMAaQB0AGkAbwBuADoATQB3AEEANABBAEQAWQBBAE8AUQBBAD0ACgBwAHIAZQBmAGkAeAA6AAoAcwBvAHUAcgBjAGUAOgBZAEEAQgBnAEEARwBBAEEAZQB3AEIANwBBAEgASQBBAGYAUQBCADkAQQBBAG8AQQBJAHcAQQBnAEEARgBJAEEASQBBAEIAagBBAEcAOABBAFoAQQBCAGwAQQBDAEEAQQBaAHcAQgB2AEEARwBVAEEAYwB3AEEAZwBBAEcAZwBBAFoAUQBCAHkAQQBHAFUAQQBDAGcAQgBnAEEARwBBAEEAWQBBAEEAPQAKAHMAdQBmAGYAaQB4ADoA:31b8e172-b470-440e-83d8-e6b185028602

Python, Julia, and Observable chunks executed with jupyter 31b8e172-b470-440e-83d8-e6b185028602:dAB5AHAAZQA6AE8AUQBCAGoAQQBHAEkAQQBOAHcAQQA1AEEARwBVAEEATgBnAEIAagBBAEMAMABBAE8AQQBBADQAQQBEAGcAQQBaAEEAQQB0AEEARABRAEEAWQBRAEEAdwBBAEcAVQBBAEwAUQBBADUAQQBHAE0AQQBPAFEAQgBpAEEAQwAwAEEAWgBnAEIAbQBBAEQAWQBBAE4AdwBCAGoAQQBHAFEAQQBOAEEAQQB3AEEARABRAEEAWgBRAEEAMgBBAEQAQQBBAAoAcABvAHMAaQB0AGkAbwBuADoATQB3AEEANQBBAEQAawBBAE4AZwBBAD0ACgBwAHIAZQBmAGkAeAA6AAoAcwBvAHUAcgBjAGUAOgBZAEEAQgBnAEEARwBBAEEAZQB3AEIANwBBAEgASQBBAGYAUQBCADkAQQBBAG8AQQBJAHcAQQBnAEEARgBBAEEAZQBRAEIAMABBAEcAZwBBAGIAdwBCAHUAQQBDAEEAQQBZAHcAQgB2AEEARwBRAEEAWgBRAEEAZwBBAEcAYwBBAGIAdwBCAGwAQQBIAE0AQQBJAEEAQgBvAEEARwBVAEEAYwBnAEIAbABBAEEAbwBBAFkAQQBCAGcAQQBHAEEAQQAKAHMAdQBmAGYAaQB4ADoA:31b8e172-b470-440e-83d8-e6b185028602

Quarto + various document types

Documents

• Bold palmerpenguins and add link to https://allisonhorst.github.io/palmerpenguins/.
• Add code chunk options with YAML completion:
  • fig-alt
  • code-fold
  • echo: fenced
• Annotate table making code # <1>
  1. Take penguins data frame , and then, # <2>
  2. Slice the top 10 rows, and then, # <3>
  3. Select the variables indicates, and then, # <4>
  4. Make a gt table
• Add code-annotation: hover to YAML, and then change to code-annotation: select, and then remove
• Add a citation: 10.1371/journal.pone.0090081 to palmerpenguins
• Make document PDF

Slides

• Change format: revealjs

• Add section headings: First level headings Introduction and Analysis, under Analysis a second level heading called Modeling

• Add columns to slides

• Reveal code with echo: true

• teaching-tip: code-line-numbers

• Change output-location of figure

Websites

• Add Quarto file and call it index.qmd

• Add _quarto.yml

• Restart project

• Build Tab > Render Website

Journal articles

Soon: Reproducible manuscripts with embedded computation

Parting remarks

Quarto CLI…

orchestrates each step of rendering

Artwork from “Hello, Quarto” keynote by Julia Lowndes and Mine Çetinkaya-Rundel, presented at RStudio Conference 2022. Illustrated by Allison Horst.

Learning more

https://quarto.org

Follow up with…

the Quarto Blog: https://quarto.org/docs/blog

Thank you!

🐘 https://fosstodon.org/@minecr

✉️ mailto:mc301@duke.edu